###Function###
PixelSearch

###Description###
Durchsucht ein Rechteck von Pixeln nach einer vorgegebenen Farbe.

###Syntax###
PixelSearch ( left, top, right, bottom, color [, shade-variation = 0 [, step = 1 [, hwnd]]] )


###Parameters###
@@ParamTable@@
left
	linke Koordinate des Rechtecks.
top
	obere Koordinate des Rechtecks.
right
	rechte Koordinate des Rechtecks.
bottom
	untere Koordinate des Rechtecks.
color
	Farbwert des zu suchenden Pixels (in dezimal oder hex).
shade-variation
	[optional] Eine Zahl zwischen 0 und 255, die die Anzahl erlaubter Schattierungsschwankungen der Rot-, Grn- und Blaukomponenten festlegt. Standard ist 0 (exakte bereinstimmung).
step
	[optional] Anstatt jedes Pixel in die Prfsumme einzubeziehen, kann man einen Wert grer als 1 verwenden um Pixel zu berspringen (schneller). z.B. wird ein Wert von 2 nur jedes zweite Pixel prfen. Standard ist 1. <b>Es wird nicht empfohlen, einen greren Wert als 1 zu verwenden.</b>
hwnd
	[optional] Handle des zu durchsuchenden Fensters.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	ein 2-Element-Array der Pixelkoordinaten. (Array[0] = x, Array[1] = y)
Fehler:	Setzt @error auf 1, wenn die Farbe nicht gefunden wurde.
@@End@@


###Remarks###
Die Suchrichtung variiert wie folgt:
	Links nach Rechts - links < rechts
	rechts nach Links - rechts < links
	Oben nach unten - oben < unten
	Unten nach oben - unten < oben
Das ndern der Suchrichtung kann eine sinnvolle Optimierung sein falls die zu suchende Farbe hauptschlich in einem festgelegten Bereich des Suchbereichs auftaucht. Durch das starten der Suche in diesen Bereich wird die Suche schneller abgeschlossen sein.

Es ist zu bedenken, dass ein typisches 1024x768 Bild 786432 Pixel beinhaltet. Obwohl <a href="PixelSearch.htm">PixelSearch()</a> optimiert wurde, erhht das Einschrnken des Suchbereichs die Geschwindigkeit erheblich.


###Related###
PixelChecksum, PixelGetColor, PixelCoordMode (Option)


###Example###
@@IncludeExample@@
